package com.example.forum.services;

import com.example.forum.model.Article;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * Created with IntelliJ IDEA.
 * Description:
 * User: liuli
 * Date: 2024-08-13
 * Time: 18:47
 */

public interface IArticleService {
    /**
     * 发布帖子
     * @param article 要发布的帖子
     */
    @Transactional //当前方法中的执行过程会被事务管理起来
    void create(Article article);

    /**
     * 查询所有帖子列表
     * @return
     */
    List<Article> selectAll();

    /**
     * 根据版块Id查询帖子列表,以发布时间降序排列
     * @param boardId 版块Id
     * @return 帖⼦列表
     */
    List<Article> selectAllByBoardId (Long boardId);

    /**
     * 根据帖子id查询详情
     * @param id 帖子id
     * @return 帖子详情
     */
    Article selectDetailById(Long id);


    /**
     * 根据帖子id查询记录
     * @param id 帖子id
     * @return
     */
    Article selectById(Long id);

    /**
     * 根据帖子Id更新帖子标题与内容
     * @param id 帖子Id
     * @param title 标题
     * @param content 内容
     */
    void modify(Long id, String title, String content);

    /**
     * 点赞
     * @param id 帖⼦Id
     */
    void thumbsUpById (Long id);

   /**
    * 根据Id删除帖子
    * @param id 帖子Id
    *
    */
    @Transactional // 事务管理
    void deleteById(Long id);

    /**
     * 文章回复数量 +1
     * @param id 文章id
     */
    void addOneReplyCountById(Long id);


    /**
     * 根据用户id查询帖子列表
     * @param userId 用户id
     * @return 帖子列表
     */
    List<Article> selectByUserId( Long userId);

}
